Skip to content

Add javadoc to generated gRPC service class public API#3

Merged
merlimat merged 1 commit intomasterfrom
grpc-javadoc
Mar 17, 2026
Merged

Add javadoc to generated gRPC service class public API#3
merlimat merged 1 commit intomasterfrom
grpc-javadoc

Conversation

@merlimat
Copy link
Collaborator

Summary

Add javadoc comments to all public methods and inner types in generated gRPC service classes.

Changes

Single file: LightProtoService.java

Javadoc added to:

  • getXxxMethod() descriptor getters - uses proto method doc when available, otherwise a default description
  • newStub() / newBlockingStub() factory methods
  • getServiceDescriptor() / bindService() utility methods
  • AsyncService interface, ImplBase abstract class, Stub and BlockingStub inner classes

Test plan

  • All 199 tests pass
  • Verified generated TestServiceGrpc.java has javadoc on every public method and type

Generated gRPC service classes (e.g., TestServiceGrpc) now have
javadoc on all public methods and inner types:
- Class-level: uses proto service comment (already present)
- getXxxMethod(): uses proto method doc or default description
- newStub() / newBlockingStub(): factory method descriptions
- getServiceDescriptor() / bindService(): utility descriptions
- AsyncService, ImplBase, Stub, BlockingStub: class-level docs
@merlimat merlimat merged commit 05cd08b into master Mar 17, 2026
1 check passed
@merlimat merlimat deleted the grpc-javadoc branch March 17, 2026 22:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant